package com.example.forum.services;

import com.example.forum.model.Article;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

/**
 * @Description: TODO
 * @Author Mr.Tang
 */
public interface IArticleService {

    /**
     *  发布帖子
     * @param article 要发布的帖子
     */
    @Transactional  // 让当前方法中的执行过程被事务管理起来
    void create (Article article);


    /**
     * 查询所有帖子列表
     * @return 帖子列表
     */
    List<Article> selectAll();


    /**
     * 根据版块Id查询所有帖子列表
     * @param boardId 版块Id
     * @return 列表
     */
    List<Article> selectAllByBoardId(Long boardId);


    /**
     * 根据帖子Id查询详情
     * @param id 帖子Id
     * @return 帖子详情
     */
    Article selectDetailById(Long id);


    /**
     * 根据帖子ID查询记录（没有表关联，只查帖子信息）,单独用这个效率高一点
     * @param id 帖子Id
     * @return
     */
    Article selectById(Long id);


    /**
     * 更具用户 id 查询帖子列表
     * @param userId 用户 id
     * @return 帖子列表
     */
    List<Article> selectByUserId(Long userId);


    /**
     *  编辑帖子信息
     * @param id 帖子ID
     * @param title 帖子标题
     * @param content 帖子正文
     */
    void modify(Long id, String title, String content);


    /**
     * 点赞帖子
     * @param id 帖子Id
     */
    void likeUpById(Long id);


    /**
     * 根据Id删除帖子
     * @param id 帖子Id
     */
    @Transactional
    void deleteById(Long id);


    /**
     *  更新帖子中的回复数（+1）
     * @param id 版块Id
     */
    void addOneReplyCountById(Long id);


}
